home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 081 / opus2.arc / ODOC_000.ARC / REF_MENU.DOC < prev    next >
Encoding:
Text File  |  1986-11-16  |  6.9 KB  |  177 lines
  1.  
  2.                                      OPUS
  3.  
  4.            (c) Copyright 1986, Wynn Wagner III, All Rights Reserved
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                     CHOICES
  14.  
  15.                                 11 October 1986
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                         "In case of fire, yell FIRE!"
  27.                                          --- The Management
  28.  
  29.  
  30.  
  31.  
  32.  
  33. This pamphlet describes the menu files (or "priv files") used by Opus.
  34.  
  35. Opus needs 5 menu files.  Unlike Fido<tm>, Opus contains no built-in
  36. menus.  If the files are not available, your Opus system will fail to
  37. operate correctly.
  38.  
  39. Although Opus should operate correctly with most Fido<tm> menu files,
  40. it's better and safer to use the Opus files.
  41.  
  42. Here is a list of the menu files.  The Opus-only commands are listed
  43. in this chart ... 
  44.  
  45.  
  46.    | Menu file    | Notes                                            |
  47.    |--------------+--------------------------------------------------|
  48.    | MAINPRIV.BBS | The main menu                                    |
  49.    |--------------+--------------------------------------------------|
  50.    | CHGPRIV.BBS  | The change setup menu                            |
  51.    |              |         * G)RAPHICS                              |
  52.    |              |         * S)CREEN CLEAR                          |
  53.    |              |         NOTE: N)ame is not currently supported   |
  54.    |--------------+--------------------------------------------------|
  55.    | FILEPRIV.BBS | The file section menu                            |
  56.    |              |         * C)ONTENTS                              |
  57.    |              |         * H)URL                                  |
  58.    |              |         * O)RPHAN                                |
  59.    |              |                                                  |
  60.    |              |         NOTE: four other commands are available  |
  61.    |              |               but don't appear on the menu:      |
  62.    |              |                                                  |
  63.    |              |                  LV       ... list verbose       |
  64.    |              |                  SV       ... scan verbose       |
  65.    |              |                  L*       ... list new           |
  66.    |              |                  LV*      ... list verbose new   |
  67.    |--------------+--------------------------------------------------|
  68.    | MSGPRIV.BBS  | The message section menu                         |
  69.    |              |         NOTE: K)ILL is not supported on this     |
  70.    |              |               menu.  It is included on the       |
  71.    |              |               read-messages menu                 |
  72.    |              |         NOTE: S)TATS in Fido<tm> is called       |
  73.    |              |               S)CAN in Opus.                     |
  74.    |--------------+--------------------------------------------------|
  75.    | MAILPRIV.BBS | The network menu                                 |
  76.    |--------------+--------------------------------------------------|
  77.    | READPRIV.BBS | The read-messages menu                           |
  78.    |              |         * =)NON-STOP READ                        |
  79.    |              |         NOTE: Message threads in this            |
  80.    |              |               release misbehave sometimes. We    |
  81.    |              |               suggest you set + and - to hidden. |
  82.    +--------------+--------------------------------------------------+
  83.  
  84.  
  85.  
  86.  
  87. ADVANCED TOPICS
  88. ------------------------------------------------------------------------------
  89. You will find advanced customization features here.  If you consider
  90. yourself a novice sysop, please put the rest of this pamphlet away until 
  91. a later date.  You can lead a meaningful life without going through any of
  92. this material.  In fact, you could end up doing more damage than good
  93. unless you really know what you are doing.
  94.  
  95.  
  96.  
  97.  
  98.  
  99. STRUCTURE
  100. ------------------------------------------------------------------------------
  101. There is no difference in the physical format of the files.  Both systems
  102. use an array of records or structures.  Here is the C-language definition
  103. of the menu structure:
  104.  
  105.                            struct _cmd {
  106.                                 char name[20];
  107.                                 int priv;
  108.                            };
  109.  
  110.  
  111.  
  112.  
  113.  
  114. FUNCTIONAL DIFFERENCES: COMMANDS
  115. ------------------------------------------------------------------------------
  116. Opus does not demand any particular character be used for the various menu
  117. selections.  In other words, if you don't like "M)ain-menu" on a particular
  118. menu, there's nothing to stop you from using a message editor or a low level
  119. file editor (eg. Norton) to change the selection into "T)op".
  120.  
  121. The POSITION of the menu selection is very important.  In the above example,
  122. if "M)ain-menu" is, say, the third item in the menu file, you must make 
  123. sure you put "T)op" in the third position.
  124.  
  125. The command character must be an uppercase alpha character (ie A,B,C..Z).
  126. You should NEVER use a digit or punctuation.
  127.  
  128. It is your responsibility to make sure you don't duplicate a character on
  129. the same menu.  In other words, if you use "M" for two commands, the second
  130. command will be unavailable.
  131.  
  132.  
  133.  
  134.  
  135. FUNCTIONAL DIFFERENCES: DISPLAY
  136. ------------------------------------------------------------------------------
  137. Some system operators add spaces to the end of various menu commands using
  138. a low-level file editor.  This is an attempt to force Fido<tm> to line up
  139. menus in columns.
  140.  
  141. Such an effort is meaningless here.  Opus always displays Novice menus
  142. in a columnar format.  In fact, Opus will adjust the menu display to fit
  143. the caller's screen width.
  144.  
  145.  
  146.  
  147.  
  148.  
  149. PROGRAMMER'S OPINION ON CUSTOMIZED MENUS
  150. ------------------------------------------------------------------------------
  151. One of the strongest points in favor of Fido<tm> is the similarity between
  152. systems.  If you call any Fido<tm> BBS, then you know which characters
  153. do what actions.
  154.  
  155. Opus gives its system operator an order of magnitude more power than does
  156. Fido<tm>.  Along with this freedom to customize various features comes a
  157. great deal of responsibility.
  158.  
  159. You have the ability to customize menus, but I personally think it's a
  160. very very very very bad idea to change everything just to be different.
  161.  
  162. An example of a good place for customizing is the "E" command on the main
  163. menu.  Some sysops want an "E)ditorial."  Others want "E)xtra info."  You
  164. might even want something like "W)ant ads".  Those sorts of changes are
  165. wonderful and can had a personal touch to your system.
  166.  
  167. Changing "R)ead messages" into "V)iew messages", on the other hand, is
  168. gratuitous modification.  It can only confuse the users.
  169.  
  170. So, while I feel that it's a good idea to give you lots of freedom and
  171. power over your system, I also feel that I need to ask that you not abuse
  172. that freedom and power.
  173.  
  174.  
  175.                                       ###
  176.  
  177.